home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat1 / pmkstat.z / pmkstat
Text File  |  1997-04-03  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMKKKKSSSSTTTTAAAATTTT((((1111))))                                                          PPPPMMMMKKKKSSSSTTTTAAAATTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmkkkkssssttttaaaatttt - high-level system performance overview
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppmmmmkkkkssssttttaaaatttt [----AAAA _a_l_i_g_n] [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----nnnn _n_a_m_e_s_p_a_c_e] [----OOOO _t_i_m_e] [----dddd]
  13.      [----SSSS _t_i_m_e] [----ssss _s_a_m_p_l_e_s] [----TTTT _t_i_m_e] [----tttt _i_n_t_e_r_v_a_l] [----zzzz] [----ZZZZ _t_i_m_e_z_o_n_e]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmkkkkssssttttaaaatttt provides a one line summary of system performance every _i_n_t_e_r_v_a_l
  17.      unit of time (the default is 5 seconds).  ppppmmmmkkkkssssttttaaaatttt is intended to monitor
  18.      system performance at the highest level, after which other tools may be
  19.      used to examine subsystems in which potential performance problems may be
  20.      observed in greater detail.
  21.  
  22.      The _i_n_t_e_r_v_a_l argument follows the syntax described in
  23.      ____ppppmmmmPPPPaaaarrrrsssseeeeIIIInnnntttteeeerrrrvvvvaaaallll(3), and in the simplest form may be an unsigned integer
  24.      (the implied units in this case are seconds).
  25.  
  26.      By default, metrics are fetched from the local host using the _l_i_b_p_c_p__l_i_t_e
  27.      implementation that does not involve ppppmmmmccccdddd(1), however if the ----hhhh option is
  28.      specified, then ppppmmmmkkkkssssttttaaaatttt will eeeexxxxeeeecccc(2) /_u_s_r/_p_c_p/_l_i_b/_r_p_m_k_s_t_a_t to connect to
  29.      the Performance Metrics Collector Daemon (PMCD) on _h_o_s_t and fetch metrics
  30.      from there.
  31.  
  32.      Alternatively, if the ----aaaa option is used, the metrics are retrieved from
  33.      the Performance Co-Pilot archive log files identified by the base name
  34.      _a_r_c_h_i_v_e (this also involves /_u_s_r/_p_c_p/_l_i_b/_r_p_m_k_s_t_a_t and the fully function
  35.      _l_i_b_p_c_p, as archives are not supported using _l_i_b_p_c_p__l_i_t_e).
  36.  
  37.      Using an archive implies a host name, and nominating a host precludes
  38.      using an archive, so the options ----aaaa and ----hhhh are mutually exclusive.
  39.  
  40.      Normally ppppmmmmkkkkssssttttaaaatttt operates on the default Performance Metrics Namespace
  41.      (PMNS), however if the ----nnnn option is specified an alternative namespace is
  42.      loaded from the file _n_a_m_e_s_p_a_c_e.
  43.  
  44.      If the ----ssss the option is specified, _s_a_m_p_l_e_s defines the number of samples
  45.      to be retrieved and reported.  If _s_a_m_p_l_e_s is 0 or ----ssss is not specified,
  46.      ppppmmmmkkkkssssttttaaaatttt will sample and report continuously - this is the default
  47.      behaviour.
  48.  
  49.      The ----SSSS, ----TTTT, ----OOOO and ----AAAA options may be used to define a time window to
  50.      restrict the samples retrieved, set an initial origin within the time
  51.      window, or specify a ``natural'' alignment of the sample times; refer to
  52.      ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) for a complete description of these options.
  53.  
  54.      Also when using archives, the ----dddd option requests that the prevailing
  55.      real-time delay be applied between samples (see ----tttt) to effect a pause,
  56.      rather than the default behaviour of replaying at full speed.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMKKKKSSSSTTTTAAAATTTT((((1111))))                                                          PPPPMMMMKKKKSSSSTTTTAAAATTTT((((1111))))
  71.  
  72.  
  73.  
  74.      The output from ppppmmmmkkkkssssttttaaaatttt is directed to standard output, and the columns
  75.      in the report are interpreted as follows:
  76.  
  77.      rrrruuuunnnnqqqq      Average number of runnable processes in main memory (mmmmeeeemmmm) and
  78.                in swap memory (sssswwwwpppp) during the interval.
  79.  
  80.      mmmmeeeemmmmoooorrrryyyy    The ffffrrrreeeeeeee column indicates average free memory during the
  81.                interval, in Kbytes.  The ppppaaaaggggeeee column is the average number of
  82.                page out operations per second during the interval.  I/Os
  83.                caused by these page out operations are included in the write
  84.                I/O rate (see ddddiiiisssskkkkssss, below).
  85.  
  86.      ssssyyyysssstttteeeemmmm    System call rate (ssssccccaaaallllllll), context switch rate (ccccttttxxxxsssswwww) and
  87.                interrupt rate (iiiinnnnttttrrrr).  Rates are expressed as average
  88.                operations per second during the interval.
  89.  
  90.      ddddiiiisssskkkkssss     Aggregated physical read (rrrrdddd) and write (wwwwrrrr) rates over all
  91.                disks, expressed as physical I/Os issued per second during the
  92.                interval.
  93.  
  94.      ccccppppuuuu       Percentage of CPU time spent executing user code (uuuussssrrrr), system
  95.                and interrupt code (ssssyyyyssss), idle loop (iiiiddddllll) and idle waiting for
  96.                resources, typically disk I/O (wwwwtttt).
  97.  
  98.      If any values for the associated performance metrics are unavailable, the
  99.      value appears as ``?'' in the output.
  100.  
  101.      By default, ppppmmmmkkkkssssttttaaaatttt reports the time of day according to the local
  102.      timezone on the system where ppppmmmmkkkkssssttttaaaatttt is run.  The ----ZZZZ option changes the
  103.      timezone to _t_i_m_e_z_o_n_e in the format of the environment variable TTTTZZZZ as
  104.      described in eeeennnnvvvviiiirrrroooonnnn(5).  The ----zzzz option changes the timezone to the local
  105.      timezone at the host that is the source of the performance metrics, as
  106.      identifed via either the ----hhhh or ----aaaa options.
  107.  
  108. NNNNOOOOTTTTEEEESSSS
  109.      The interrupt (iiiinnnnttttrrrr) rate includes the high frequency clock (and possibly
  110.      some video-related and/or audio-related interrupts), and differs widely,
  111.      even on idle systems, depending upon the hardware configuration.  A more
  112.      useful measure would be the delta above the quiescent interrupt rate on
  113.      an idle system, but we have no way of measuring this.
  114.  
  115. FFFFIIIILLLLEEEESSSS
  116.      ////vvvvaaaarrrr////ppppccccpppp////ppppmmmmnnnnssss////*                   default PMNS specification files
  117.      ////uuuussssrrrr////ppppccccpppp////lllliiiibbbb////rrrrppppmmmmkkkkssssttttaaaatttt             used for archives and remote metrics
  118.                                        access
  119.      ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....ppppmmmmkkkkssssttttaaaatttt
  120.                                        ppppmmmmllllooooggggggggeeeerrrr(1) configuration for creating
  121.                                        an archive suitable for replay with
  122.                                        ppppmmmmkkkkssssttttaaaatttt
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMKKKKSSSSTTTTAAAATTTT((((1111))))                                                          PPPPMMMMKKKKSSSSTTTTAAAATTTT((((1111))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmcccclllliiiieeeennnntttt(1), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmPPPPaaaarrrrsssseeeeTTTTiiiimmmmeeeeWWWWiiiinnnnddddoooowwww(3) and
  142.      ____ppppmmmmPPPPaaaarrrrsssseeeeIIIInnnntttteeeerrrrvvvvaaaallll(3).
  143.  
  144. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  145.      All are generated on standard error, and are intended to be self-
  146.      explanatory.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.